home *** CD-ROM | disk | FTP | other *** search
/ Internet Info 1994 March / Internet Info CD-ROM (Walnut Creek) (March 1994).iso / inet / internet-drafts / draft-ietf-madman-mtamib-01.txt < prev    next >
Encoding:
Text File  |  1993-07-08  |  16.2 KB  |  548 lines
  1.  
  2.                             Internet Draft
  3.                          Mail Monitoring MIB
  4.  
  5.                                Ned Freed
  6.                               Steve Kille
  7.  
  8.                           MADMAN Working Group
  9.                              June 26, 1993
  10.                       Expires: December 26, 1993
  11.  
  12. Status of this Memo
  13.  
  14. This document is an Internet Draft. Internet Drafts are working
  15. documents of the Internet Engineering Task Force (IETF), its Areas,
  16. and its Working Groups. Note that other groups may also distribute
  17. working documents as Internet Drafts.
  18.  
  19. Internet Drafts are draft documents valid for a maximum of six 
  20. months.    Internet Drafts may be updated, replaced, or obsoleted by
  21. other documents at any time.  It is not appropriate to use Internet
  22. Drafts as reference material or to cite them other than as a "working
  23. draft" or "work in progress."
  24.  
  25. Please check the I-D abstract listing contained in each Internet 
  26. Draft directory to learn the current status of this or any  other
  27. Internet Draft.
  28.  
  29. Abstract
  30.  
  31. This document extends the basic Network Services Monitoring MIB to
  32. allow monitoring of Message Transfer Agents (MTAs).
  33.  
  34. MTA Objects
  35.  
  36. If there are one or more MTAs on the host, the following mta group may
  37. be used to monitor them. Any number of the MTAs on a host may be
  38. monitored. Each MTA is dealt with as a separate application and has
  39. its own applTable entry in the Network Services Monitoring MIB.
  40.  
  41. Message Flow Model
  42.  
  43. A general model of message flow inside an MTA has to be presented
  44. before a MIB can be described. Generally speaking, message flow occurs
  45. in four steps:
  46.  
  47. (1) Messages are submitted to the MTA by User Agents, Message
  48.     Stores, other MTAs, and gateways.
  49.  
  50. (2) The "next hop" for the each message is determined. This is simply the
  51.     destination the message is to be delivered to; it may or may not be the
  52.     final destination of the message. Multiple "next hops" may exist for a
  53.     single message (as a result of either having multiple recipients or
  54.     distribution list expansion); this may make it necessary to duplicate
  55.     messages.
  56.  
  57. (3) Messages are converted into the format that's appropriate for the next
  58.     hop.
  59.  
  60. (4) Messages are delivered to the appropriate destination, which may be a
  61.     User Agent, Message Store, another MTA, or another gateway.
  62.  
  63. Storage of messages in the MTA occurs at some point during this
  64. process. However, it is important to note that storage may occur at
  65. different and possibly even multiple points during this process. For
  66. example, some MTAs expand messages into multiple copies as they are
  67. received. In this case (1), (2), and (3) all occur prior to storage.
  68. Other MTAs store messages precisely as they are received and perform
  69. all expansion and conversion processing during retransmission
  70. processing. So here only (1) occurs prior to storage. This leads to a
  71. situation where, in general, a measurement of messages received may
  72. not equal a measurement of messages in store, a measurement of
  73. messages stored may not equal a measurement of messages retransmitted,
  74. or both.
  75.  
  76. MTA-MIB DEFINITIONS ::= BEGIN
  77.  
  78. IMPORTS
  79.     OBJECT-TYPE FROM RFC-1212
  80.     experimental, Counter, Gauge FROM RFC1155-SMI
  81.     DisplayString FROM RFC1213-MIB
  82.     applIndex, applProtoID FROM APPLICATION-MIB;
  83.  
  84. mta OBJECT IDENTIFIER ::= {experimental 47}
  85.  
  86. mtaTable OBJECT-TYPE
  87.     SYNTAX SEQUENCE OF MTAEntry
  88.     ACCESS not-accessible
  89.     STATUS mandatory
  90.     DESCRIPTION
  91.       "The table holding information specific to an MTA."
  92.     ::= {mta 1}
  93.  
  94. mtaEntry OBJECT-TYPE
  95.     SYNTAX MTAEntry
  96.     ACCESS not-accessible
  97.     STATUS mandatory
  98.     DESCRIPTION
  99.       "The entry associated with each MTA."
  100.     INDEX {applIndex}
  101.     ::= {mtaTable 1}
  102.  
  103. MTAEntry ::= SEQUENCE {
  104.     mtaSubmittedMessages
  105.       Counter,
  106.     mtaStoredMessages
  107.       Gauge,
  108.     mtaDeliveredMessages
  109.       Counter,
  110.     mtaSubmittedVolume
  111.       Counter,
  112.     mtaStoredVolume
  113.       Gauge,
  114.     mtaDeliveredVolume
  115.       Counter,
  116.     mtaSubmittedRecipients
  117.       Counter,
  118.     mtaStoredRecipients
  119.       Gauge,
  120.     mtaDeliveredRecipients
  121.       Counter
  122. }
  123.   
  124. mtaSubmittedMessages OBJECT-TYPE
  125.     SYNTAX Counter
  126.     ACCESS read-only
  127.     STATUS mandatory
  128.     DESCRIPTION
  129.       "The number of messages submitted since MTA initialization."
  130.     ::= {mtaEntry 1}
  131.  
  132. mtaStoredMessages OBJECT-TYPE
  133.     SYNTAX Gauge
  134.     ACCESS read-only
  135.     STATUS mandatory
  136.     DESCRIPTION
  137.        "The total number of messages currently stored in the MTA."
  138.     ::= {mtaEntry 2}
  139.  
  140. mtaDeliveredMessages OBJECT-TYPE
  141.     SYNTAX Counter
  142.     ACCESS read-only
  143.     STATUS mandatory
  144.     DESCRIPTION
  145.       "The number of messages delivered since MTA initialization."
  146.     ::= {mtaEntry 3}
  147.  
  148. mtaSubmittedVolume OBJECT-TYPE
  149.     SYNTAX Counter
  150.     ACCESS read-only
  151.     STATUS mandatory
  152.     DESCRIPTION
  153.        "The total volume of messages submitted since MTA
  154.        initialization, measured in kbytes."
  155.     ::= {mtaEntry 4}
  156.  
  157. mtaStoredVolume OBJECT-TYPE
  158.     SYNTAX Gauge
  159.     ACCESS read-only
  160.     STATUS mandatory
  161.     DESCRIPTION
  162.        "The total volume of messages currently stored in the MTA,
  163.        measured in kbytes."
  164.     ::= {mtaEntry 5}
  165.  
  166. mtaDeliveredVolume OBJECT-TYPE
  167.     SYNTAX Counter
  168.     ACCESS read-only
  169.     STATUS mandatory
  170.     DESCRIPTION
  171.       "The total volume of messages delivered since MTA
  172.       initialization, measured in kbytes."
  173.     ::= {mtaEntry 6}
  174.  
  175. mtaSubmittedRecipients OBJECT-TYPE
  176.     SYNTAX Counter
  177.     ACCESS read-only
  178.     STATUS mandatory
  179.     DESCRIPTION
  180.        "The total number of recipients specified in all messages submitted
  181.        since MTA initialization."
  182.     ::= {mtaEntry 7}
  183.  
  184. mtaStoredRecipients OBJECT-TYPE
  185.     SYNTAX Gauge
  186.     ACCESS read-only
  187.     STATUS mandatory
  188.     DESCRIPTION
  189.        "The total number of recipients specified in all messages currently
  190.        stored in the MTA."
  191.     ::= {mtaEntry 8}
  192.  
  193. mtaDeliveredRecipients OBJECT-TYPE
  194.     SYNTAX Counter
  195.     ACCESS read-only
  196.     STATUS mandatory
  197.     DESCRIPTION
  198.       "The total number of recipients specified in all messages delivered
  199.       since MTA initialization."
  200.     ::= {mtaEntry 9}
  201.  
  202. -- MTAs typically group inbound submissions, queue storage, and
  203. -- outbound deliveries in some way. In the most extreme case
  204. -- information will be maintained for each different entity that
  205. -- submits messages and for each entity the MTA stores messages for
  206. -- and delivers messages to.  Other MTAs may elect to treat all
  207. -- submissions equally, all queue storage equally, all deliveries
  208. -- equally, or some combination of this.
  209.  
  210. -- In any case, a grouping abstraction is an extremely useful for
  211. -- breaking down the activities of an MTA. For purposes of labelling
  212. -- this will be called a "group" in this MIB.
  213.  
  214. -- The term "channel" is often used in MTA implementations; channels
  215. -- are usually, but not always, equivalent to a "group". However,
  216. -- this MIB does not use the term "channel" because there is no
  217. -- requirement that an MTA supporting this MIB has to map its
  218. -- "channel" abstration one-to-one onto the MIB's group abstration.
  219.  
  220. mtaGroupTable OBJECT-TYPE
  221.     SYNTAX SEQUENCE OF MtaGroupEntry
  222.     ACCESS not-accessible
  223.     STATUS mandatory
  224.     DESCRIPTION
  225.         "The table holding information specific to each MTA group."
  226.     ::= {mta 2}
  227.  
  228. mtaGroupEntry OBJECT-TYPE
  229.     SYNTAX MtaGroupEntry
  230.     ACCESS not-accessible
  231.     STATUS mandatory
  232.     DESCRIPTION
  233.       "The entry associated with each MTA group."
  234.     INDEX {applIndex, mtaGroupIndex}
  235.     ::= {mtaGroupTable 1}
  236.  
  237. MtaGroupEntry ::= SEQUENCE {
  238.     mtaGroupIndex
  239.         INTEGER,
  240.     mtaGroupSubmittedMessages
  241.         Counter,
  242.     mtaGroupRejectedMessages
  243.         Counter,
  244.     mtaGroupStoredMessages
  245.         Gauge,
  246.     mtaGroupDeliveredMessages
  247.         Counter,
  248.     mtaGroupSubmittedVolume
  249.         Counter,
  250.     mtaGroupStoredVolume
  251.         Gauge,
  252.     mtaGroupDeliveredVolume
  253.         Counter,
  254.     mtaGroupSubmittedRecipients
  255.         Counter,
  256.     mtaGroupStoredRecipients
  257.         Gauge,
  258.     mtaGroupDeliveredRecipients
  259.         Counter,
  260.     mtaGroupQueuedMtaAssociationIndex
  261.         INTEGER,
  262.     mtaGroupOldestMessageStored
  263.         TimeTicks,
  264.     mtaGroupInboundAssociations
  265.         Gauge,
  266.     mtaGroupOutboundAssociations
  267.         Gauge,
  268.     mtaGroupAccumulatedInboundAssociations
  269.         Counter,
  270.     mtaGroupAccumulatedOutboundAssociations
  271.         Counter,
  272.     mtaGroupLastInboundActivity
  273.         TimeTicks,
  274.     mtaGroupLastOutboundActivity
  275.         TimeTicks,
  276.     mtaGroupRejectedInboundAssociations
  277.         Counter,
  278.     mtaGroupFailedOutboundAssociations
  279.         Counter,
  280.     mtaGroupInboundRejectionReason
  281.         DisplayString,
  282.     mtaGroupOutboundConnectFailureReason
  283.         DisplayString,
  284.     mtaGroupScheduledRetry
  285.         TimeTicks,
  286.     mtaGroupMailProtocol
  287.         OBJECT IDENTIFIER,
  288.     mtaGroupName
  289.         DisplayString
  290. }
  291.  
  292. mtaGroupIndex OBJECT-TYPE
  293.     SYNTAX INTEGER (1..2147483647)
  294.     ACCESS read-only
  295.     STATUS mandatory
  296.     DESCRIPTION
  297.     "The index associated with a group for a given MTA."
  298.     ::= {mtaGroupEntry 1}
  299.  
  300. mtaGroupSubmittedMessages OBJECT-TYPE
  301.     SYNTAX Counter
  302.     ACCESS read-only
  303.     STATUS mandatory
  304.     DESCRIPTION
  305.       "The number of messages submitted to this group since MTA
  306.       initialization."
  307.     ::= {mtaGroupEntry 2}
  308.  
  309. mtaGroupRejectedMessages OBJECT-TYPE
  310.     SYNTAX Counter
  311.     ACCESS read-only
  312.     STATUS mandatory
  313.     DESCRIPTION
  314.       "The number of messages rejected by this group since MTA
  315.       initialization."
  316.     ::= {mtaGroupEntry 3}
  317.  
  318. mtaGroupStoredMessages OBJECT-TYPE
  319.     SYNTAX Gauge
  320.     ACCESS read-only
  321.     STATUS mandatory
  322.     DESCRIPTION
  323.        "The total number of messages currently stored in this
  324.        group's queue."
  325.     ::= {mtaGroupEntry 4}
  326.  
  327. mtaGroupDeliveredMessages OBJECT-TYPE
  328.     SYNTAX Counter
  329.     ACCESS read-only
  330.     STATUS mandatory
  331.     DESCRIPTION
  332.       "The number of messages delivered by this group since MTA
  333.       initialization."
  334.     ::= {mtaGroupEntry 5}
  335.  
  336. mtaGroupSubmittedVolume OBJECT-TYPE
  337.     SYNTAX Counter
  338.     ACCESS read-only
  339.     STATUS mandatory
  340.     DESCRIPTION
  341.        "The total volume of messages submitted to this group since
  342.        MTA initialization, measured in kbytes."
  343.     ::= {mtaGroupEntry 6}
  344.  
  345. mtaGroupStoredVolume OBJECT-TYPE
  346.     SYNTAX Gauge
  347.     ACCESS read-only
  348.     STATUS mandatory
  349.     DESCRIPTION
  350.        "The total volume of messages currently stored in this
  351.        group's queue, measured in kbytes."
  352.     ::= {mtaGroupEntry 7}
  353.  
  354. mtaGroupDeliveredVolume OBJECT-TYPE
  355.     SYNTAX Counter
  356.     ACCESS read-only
  357.     STATUS mandatory
  358.     DESCRIPTION
  359.       "The total volume of messages delivered by this group since
  360.       MTA initialization, measured in kbytes."
  361.     ::= {mtaGroupEntry 8}
  362.  
  363. mtaGroupSubmittedRecipients OBJECT-TYPE
  364.     SYNTAX Counter
  365.     ACCESS read-only
  366.     STATUS mandatory
  367.     DESCRIPTION
  368.        "The total number of recipients specified in all messages
  369.        submitted to this group since MTA initialization."
  370.     ::= {mtaGroupEntry 9}
  371.  
  372. mtaGroupStoredRecipients OBJECT-TYPE
  373.     SYNTAX Gauge
  374.     ACCESS read-only
  375.     STATUS mandatory
  376.     DESCRIPTION
  377.        "The total number of recipients specified in all messages
  378.        currently stored in this group's queue."
  379.     ::= {mtaGroupEntry 10}
  380.  
  381. mtaGroupDeliveredRecipients OBJECT-TYPE
  382.     SYNTAX Counter
  383.     ACCESS read-only
  384.     STATUS mandatory
  385.     DESCRIPTION
  386.       "The total number of recipients specified in all messages
  387.       delivered by this group since MTA initialization."
  388.     ::= {mtaGroupEntry 11}
  389.  
  390. mtaGroupQueuedMtaAssociationIndex OBJECT-TYPE
  391.     SYNTAX INTEGER (0..2147483647)
  392.     ACCESS read-only
  393.     STATUS mandatory
  394.     DESCRIPTION
  395.       "Reference into association table to allow correlation of this
  396.       group's active association with the association table.  If
  397.       there is no active association for this group this value should
  398.       be 0."
  399.     ::= {mtaGroupEntry 12}
  400.  
  401. mtaGroupOldestMessageStored OBJECT-TYPE
  402.     SYNTAX TimeTicks
  403.     ACCESS read-only
  404.     STATUS mandatory
  405.     DESCRIPTION
  406.       "The age of the oldest message in this group's queue."
  407.     ::= {mtaGroupEntry 13}
  408.  
  409. mtaGroupInboundAssociations OBJECT-TYPE
  410.     SYNTAX Gauge
  411.     ACCESS read-only
  412.     STATUS mandatory
  413.     DESCRIPTION
  414.       "The number of current associations to the group, where the
  415.        group is the responder."
  416.     ::= {mtaGroupEntry 14}
  417.  
  418. mtaGroupOutboundAssociations OBJECT-TYPE
  419.     SYNTAX Gauge
  420.     ACCESS read-only
  421.     STATUS mandatory
  422.     DESCRIPTION
  423.       "The number of current associations to the group, where the
  424.       group is the initiator."
  425.     ::= {mtaGroupEntry 15}
  426.  
  427. mtaGroupAccumulatedInboundAssociations OBJECT-TYPE
  428.     SYNTAX Counter
  429.     ACCESS read-only
  430.     STATUS mandatory
  431.     DESCRIPTION
  432.       "The total number of associations to the group since MTA
  433.       initialization, where the group is the responder."
  434.     ::= {mtaGroupEntry 16}
  435.  
  436. mtaGroupAccumulatedOutboundAssociations OBJECT-TYPE
  437.     SYNTAX Counter
  438.     ACCESS read-only
  439.     STATUS mandatory
  440.     DESCRIPTION
  441.       "The total number of associations from the group since MTA
  442.        initialization, where the group was the initiator."
  443.     ::= {mtaGroupEntry 17}
  444.  
  445. mtaGroupLastInboundActivity OBJECT-TYPE
  446.     SYNTAX TimeTicks
  447.     ACCESS read-only
  448.     STATUS mandatory
  449.     DESCRIPTION
  450.       "Time since the last time that this group had an active
  451.       inbound association for purposes of message submission."
  452.     ::= {mtaGroupEntry 18}
  453.      
  454. mtaGroupLastOutboundActivity OBJECT-TYPE
  455.     SYNTAX TimeTicks
  456.     ACCESS read-only
  457.     STATUS mandatory
  458.     DESCRIPTION
  459.       "Time since the last time that this group had an
  460.       outbound association for purposes of message delivery."
  461.     ::= {mtaGroupEntry 19}
  462.  
  463. mtaGroupRejectedInboundAssociations OBJECT-TYPE
  464.     SYNTAX Counter
  465.     ACCESS read-only
  466.     STATUS mandatory
  467.     DESCRIPTION
  468.       "The total number of inbound associations the group has
  469.       rejected, since MTA initialization."
  470.     ::= {mtaGroupEntry 20}
  471.  
  472. mtaGroupFailedOutboundAssociations OBJECT-TYPE
  473.     SYNTAX Counter
  474.     ACCESS read-only
  475.     STATUS mandatory
  476.     DESCRIPTION
  477.       "The total number associations where the group was the
  478.       initiator and association establishment has failed,
  479.       since MTA initialization."
  480.     ::= {mtaGroupEntry 21}
  481.  
  482. mtaGroupInboundRejectionReason OBJECT-TYPE
  483.     SYNTAX DisplayString
  484.     ACCESS read-only
  485.     STATUS mandatory
  486.     DESCRIPTION
  487.       "The failure reason, if any, for the last connection this
  488.       group refused to respond to. An empty string indicates that
  489.       the last attempt was successful.  If no connection attempt has
  490.       been made since the MTA was initializaed the value should be
  491.       'never'."
  492.     ::= {mtaGroupEntry 22}
  493.  
  494. mtaGroupOutboundConnectFailureReason OBJECT-TYPE
  495.     SYNTAX DisplayString
  496.     ACCESS read-only
  497.     STATUS mandatory
  498.     DESCRIPTION
  499.       "The failure reason, if any, for the last connection attempt
  500.       this group initiated. An empty string indicates that the last
  501.       attempt was successful.  If no connection attempt has been
  502.       made since the MTA was initializaed the value should be
  503.       'never'."
  504.     ::= {mtaGroupEntry 23}
  505.  
  506. mtaGroupScheduledRetry OBJECT-TYPE
  507.     SYNTAX TimeTicks
  508.     ACCESS read-only
  509.     STATUS mandatory
  510.     DESCRIPTION
  511.       "The scheduled time at which this group will next attempt to
  512.       make a connection.  This time is relative to the query time."
  513.     ::= {mtaGroupEntry 24}
  514.  
  515. mtaGroupMailProtocol OBJECT-TYPE
  516.     SYNTAX OBJECT IDENTIFIER
  517.     ACCESS read-only
  518.     STATUS mandatory
  519.     DESCRIPTION
  520.       "An identification of the protocol being used by this group.
  521.       For an group employing OSI protocols, this will be the
  522.       Application Context.  For Internet applications, the IANA
  523.       maintains a registry of the OIDs which correspond to well-known
  524.       message transfer protocols.  If the application protocol is not
  525.       listed in the registry, the value {applProtoID port} is used
  526.       where 'port' corresponds to the primary port being used by the
  527.       group."
  528.     ::= {mtaGroupEntry 25}
  529.  
  530. mtaGroupName OBJECT-TYPE
  531.     SYNTAX DisplayString
  532.     ACCESS read-only
  533.     STATUS mandatory
  534.     DESCRIPTION
  535.       "A descriptive name for the name. If this group connects to
  536.       a single remote MTA this should be the name of that MTA. If
  537.       this in turn is an Internet MTA this should be the domain name.
  538.       For an OSI MTA it should be the string encoded distinguished
  539.       name of the managed object using the format defined in RFC-?.
  540.       For X.400(1984) MTAs which do not have a Distinguished Name,
  541.       the RFC-1327 syntax 'mta in globalid' should be used."
  542.     ::= {mtaGroupEntry 26}
  543.  
  544. END
  545.  
  546. Expires: December 26, 1993
  547.  
  548.